

STAGE™ Installation Guide for 
SunWrite™ SunPaint™ SunDraw™ 


P...,;; j: 800-2228 
ision A of 27 January 1989 



^sim 

Xr microsystems 


STAGE ” Installation Guide for 
SunWrite” SunPaint™ SunDraw™ 








Part No: 800-2228-10 
Revision A of 27 January 1989 































STAGE™, SunWiite™, SunPaint™, SunDraw™ software and documentation is proprietary to Sun 
Microsystems, Inc. Portions of the software copyright 1986,1987,1988 Island Graphics Corporation, 
copyright 1984 Proximity Technology Inc., and copyright 1984 Merriam-Webster Inc. 

Sim Microsystems, Sun Workstation, and the Sun logo are registered trademarks of Sun Microsystems, 
Inc. 

STAGE, SunView, SunOS, and the combination of Sun with a numeric suffix are trademaiks of Sun 
Microsystems, Inc. 

UNIX is a registered trademark of AT&T. 

PostScript™ is a trademark of Adobe Systems, Incorporated. 


Copyright © 1988 Sun Microsystems, Inc. - Printed in U.S.A. 

All rights reserved. No part of this work covered by copyright hereon may be reproduced in any form or by any 
means - graphic, electronic, or mechanical - including photocopying, recording, taping, or storage in an information 
retrieval system, without the prior written permission of the copyright owner. 

Restricted rights legend: use, duplication, or disclosure by the U.S. government is subject to restrictions set forth in 
subparagraph (c)(l)(ii) of the Rights in Technical Data and Computer Software clause at DEARS 52.227-7013 and in 
similar clauses in the FAR and NASA FAR Supplement. 

The Sun Graphical User Interface was developed by Sun Microsystems Inc. for its users and licensees. Sun ack¬ 
nowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user inter¬ 
faces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, 
which license also covers Sun’s licensees. 



Contents 


Preface. v 

Chapter 1 Introduction. 3 

1.1. Software Overview. 3 

1.2. Contents of the Distribution Tape. 3 

1.3. Overview of the Installation Procedure. 4 

1.4. Installation Check List. 5 

Chapter 2 Installation Procedure. 9 

2.1. Determining Space Requirements. 9 

2.2. Getting Started. 10 

2.3. Extracting the Installation Script. 10 

Using a Local Tape Drive. 11 

Local V4-inch Drive . 11 

Local V 2 -inch Drive . 11 

Using a Remote Tape Drive. 11 

Remote ‘/i-inch Drive . 12 

Remote Vi-inch Drive . 12 

Rim the Installation Script..... 12 

2.4. Install the Other Two Products. 14 

2.5. Installation Script Problems and What To Do About Them .. 14 

Chapter 3 Client Setup Procedure. 19 

3.1. Mount the Software. 19 

3.2. Install the Password. 19 




























Contents — Continued 


3.3. Choose an Installation Strategy. 19 

3.4. Create Links. 20 

3.5. Create /etc/sundesk . 20 

Chapter 4 Installing a User. 23 

4.1. User Installation Summary. 23 

4.2. Changing Your Path. 23 

4.3. Setting the SUNDESK Environment Variable. 23 

Chapter 5 Administration and User Options. 27 

5.1. System Swap Space. 27 

5.2. User-Defined Options. 27 

Copying the Default Startup Files. 27 

5.3. Starting Up SimWrite, SunPaint, or SunDraw. 28 

Customizing Your . rootmenu. 28 

Starting STAGE Programs from a Shell Window. 28 

Chapter 6 Installing the STAGE Password. 31 

6.1. Who Needs a Password?. 31 

Displaying Your Host ID. 31 

6.2. Installing A Password. 32 

6.3. Gather the Necessary Information. 32 

Sales Order Number. 32 

Right-to-Use License. 32 

6.4. Run the Installation Program. 32 

6.5. Password Installation Problems and What To Do. 34 

6.6. Installing Passwords ‘by Hand’. 35 

Appendix A SunWrite “dot” File. 39 

Appendix B SunPaint “dot” File. 49 

Appendix C SunDraw “dot” File. 53 






























Contents — Continued 


Appendix D Sun Write Printer Script. 59 

Appendix E SunDraw Printer Script. 53 

Appendix F SunPaint Printer Script. 67 


Index 


71 









Preface 


Purpose and Audience 


Summary of Contents 




Assumptions 


This document describes how to install STAGE (Stmctured Text and Graphics 
Editor) applications—SimWrite, SunPaint and SunDraw—on Sim systems 
_curEentLy-running_SunOS-Jielease-3.4,-3.5,-Ot4.0._ 

This manual helps you install STAGE software from the distribution tapes. You 
should be able to start using the STAGE products following the instructions 
contained in this manual. 

Chapter 1 — Introduction — briefly outlines the STAGE product line and 
describes the contents of the distribution tapes. 

Chapter 2 — Installation Procedure — contains the instmctions for installing the 
software onto a server. 

Chapter 3 — Client Setup Procedure — describes the procedure for installing the 
STAGE products for each client machine. 

Chapter 4 — Installing a User —contains instmctions for setting up the end 
user’s environment. 

Chapter 5— Administration and User Options — describes swap space require¬ 
ments and startup file options the user can change. 

Chapter 6 — Installing the STAGE Password —contains the STAGE password 
installation instmctions. 

Appendix A — SunWrite “dot” File — the system default start-up file 
“. sunwrite”. 

Appendix B — SunPaint “dot” File — the system default start-up file “ . sun- 
paint”. 

Appendix C — SunDraw “dot” File — the system default start-up file “. sun- 
draw”. 

Appendices D, E, and F contain listings of Shell scripts that the STAGE products 
use to spool ouqiut to the printer system. These scripts can be changed to reflect 
local differences in spooler software. 

This manual is written on the assumption that you use the C Shell as your stan¬ 
dard Shell. Where there are clear differences, instmctions for using the Bourne 











Preface — Continued 


Conventions Used in This 
Manual 


System Prompt Symbols 


Font Conventions 


Other Documentation 


Shell are provided. 

Throughout this manual we use several conventions to make the directions clear, 
general enough for all configurations, and consistent. Some of these conventions 
are UNIXf conventions, such as device names; others are Sun documentation 
conventions. Please familiarize yourself with them before continuing. 

□ The symbols: 

% percent sign 

or 

# hash sign or octothorpe 

are used as the prompt to which you type system commands. The % prompt 
indicates you can type the command finm your own login^. The # prompt 
indicates you must be the supemser (root) to type the command. 

□ Bold £ace typewriter font indicates commands that you type 
exactly as printed on the page of this manual. 

□ Regular typewriter font represents what the system displays to 
your screen. Typewriter font also specifies Sim system program names and 
file listings. 

□ Italics indicates general arguments or parameters that you should replace 
with a specific word or string. Italics are used occasionally to emphasize 
important terms. 

o Text in typewriter font representing source codelistings is sur¬ 
rounded by a box with rounded-off comers. Commands shown in a box with 
gray (simulated screen) background represent interactive workstation ses¬ 
sions. 

a STAGE Software RTF (Read This First). 

□ SunView 1 Beginner’s Guide 

□ SunWrite Tutorial and User’s Guide 

□ SunPaint Tutorial, User’s Guide, and Quick Start Guide 
o SunDraw Tutorial, User’s Guide, and Quick Start Guide 


t UNIX is a registered trademark of AT&T. 

^ If you use the Bourne Shell on your system, the user prompt wOl probably be a dollar ($) sign. 


“* viii- 




Introduction 


Introduction. 

1.1. Software Overview... 

1.2. Contents of the Distribution Tape. 

1.3. Overview of the Installation Procedure 

1.4. Installation Check List 












Introduction 


This introduction briefly describes STAGE software, lists the contents of the dis¬ 
tribution tapes, and summarizes the installation steps. This introductory chapter 
is followed by detailed installation instructions and then by an explanation of the 
various application files. 

1.1. Software Overview SunWrite, SunPaint, and SunDraw are SimView window programs. You use 

SunWrite to produce documents. You use SunPaint to create and edit raster 
images. You use SunDraw to create vector-based drawings. 

AU STAGE products are intended for use with the Sun three-button mouse. 

STAGE applications generate PostScript™ destined for Sun LaserWriter printers 
or other PostScript-compatible devices. 

PostScript files are dispatched to the printing devices through the use of Shell 
scripts in flie application-specific directories, rather than directly executing the 
printer spooler software. Although the applications were written assuming that 
the Transcript™ suit of software is available for driving the output devices, these 
assumptions can be changed by altering the appropriate Shell scripts. 

1.2. Contents of the STAGE software is shipped on three (3) Vi-inch tape cartridges, or three (3) V 2 - 

Distribution Tape inch tapes, one tape per product. The first and last tar files on each tape are 

copyright maiks. Each tape also contains five other tar files. 

NOTE Each tape is complete and independent from the others so that you may install 

one or more of the products in any combination. 


t PostScript and TranScript are trademarks of Adobe Systems, Incoiporated. 
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Table 1-1 Contents ofSunWrite Distribution Tape 


File 

Number 

Contents 

1 

Copyright mark 

2 

Installation script, install_unbundled 

3 

Product identification 

4 

SunWrite executables and support files 

5 

SunView fonts 

6 

STAGE product fonts 

7 

Copyright mark 


Table 1-2 Contents ofSunPaint Distribution Tape 


File 

Number 

Contents 

1 

Copyright mark 

2 

Installation script, install_unbundled 

3 

Product identification 

4 

SunPaint executables and support files 

5 

SunView fonts 

6 

SunPaint fonts 

7 

Copyright mark 


Table 1-3 Contents ofSunDraw Distribution Tape 


File 

Number 

Contents 

1 

Copyright mark 

2 

Installation script, install_unbundled 

3 

Product identification 

4 

SunDraw executables and support files 

5 

SunView fonts 

6 

STAGE product fonts 

7 

Copyright mark 


1.3. Overview of the 

Installation Procedure 


The summary steps required to install the STAGE products are: 

1. Before you start, familiarize yourself with each section of this manual, and 
the Read This First document. 

2. If you have a network of workstations, decide on which machine you’d like 
to load the software. This machine should be NFS mountable by other 
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machines and have enough disk space for the STAGE software. 

3. Place any one of the distribution tapes in your tape drive. You can install 
STAGE products in any order. 

4. Use tar to load the installation script from the tape. 

5. Use the installation script to load the release from the tape. 

6. Repeat the previous step for the remaining two (2) tapes, using the same 
installation script. 

7. Set up each licensed machine with the software. 

8. Install a password on each licensed machine. Passwords are for domestic 
(U.S.A.) users only. You need three passwords per machine since SunWrite, 
SunPaint, and SunDraw each have their own password. 

NOTE If you do not install a password on each machine, STAGE products will run as 
demonstration products only and you will be unable to save your work! Each 
product will display a warning message when starting up if your machine has no 
password installed. 

1.4. Installation Check List Use this list to mark your progress as you proceed through the installation. 

□ Read the Read This First. This is an important step as the Read This First 
may contain references to the installation procedure. 

□ Read this manual—^the Installation Guide. 

□ Log in to the server machine. 

□ Log in as super user. 

□ Create the installation directory and change to it. 

□ Put the first tape in the tape drive, 
n Tar installation script from tape. 

□ For each tape... 

□ execute the install_unbundled script, and 

□ replace the tape with the next tape. 

□ For each client machine... 

□ mount the software from the server, 

o install the password—if passwords are required, 

o create/etc/sundesk, and 
p create the appropriate links. 

□ If you didn’t create / et c / sunde s k in the previous step, then for each user 
you must... 

□ modify the user’s search path, and 
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□ set an environment variable, 
o Start up each product, under SunView. 
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Installation Procedure 


This chapter takes you through the product installation step-by-step. You will 
need either a 14-inch tape drive or a Vi-inch tape drive, and a machine that has 
enough disk space and is NFS mountable. 

2.1. Determining Space SunWrite, SunPaint, and SunDraw can be installed on any Sun-2 or Sun-3 woiks- 

Requirements tation that has enough disk space. 

All of the programs associated with SunWrite, SunPaint, and SunDraw are 68010 
binaries, so you don’t need to worry about heterogeneous differences between 
Sun-2 and Sun-3 workstations. 

The entire STAGE suite occupies about 12 megabytes of disk space. The space 
requirements broken down by product, including support files, are listed in Table 
2-1 —STAGE Disk Space Requirements. 

Note that the SunView fonts are shared by all three products, and are installed 
only once. STAGE fonts are shared by SunWrite and SunDraw, and are also 
installed only once. 

Table 2-1 STAGE Disk Space Requirements 


Product 

Disk Space 

SunWrite 

1.6 Mbytes 

SunPaint 

0.9 Mbytes 

SunDraw 

1.4 Mb5des 

STAGE font set 

7 Mb54es 

SunView font set 

0.5 Mbytes 


You can use the df (1) command to check your available space. For example: 


— 

# df 

Filesystem 

. kbytes 

used 

avail 

capacity 

\ 

Mounted on 

/dev/xyOa 

10964 

7628 

2239 

77% 

/ 

/dev/xyOg 

230681 

174855 

32757 

84% 

/usr 

/dev/xylc 

# 

V 

260874 

121123 

.113663 

52% 

/usr/blort 

J 
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Qioose a filesystem that has enough space for the products you plan to install. 


2.2. Getting Started 

Log in as Super-User 


Log in as super-user, root. 


‘■ . 

% su root 

—-\ 

Pas^worcJ: 




v_!- 



Create Installation Directory Create the directory into which you will install the products. For Sun-2 or Sun-3 

machines we recommend that you create the directory / usr / sundesk, and 
install the products there. To create / usr / sundesk: 




# cd /usr 


# tnkdir sundesk 


# cd sundask 




. .—.- . 



NOTE Do NOT use the root directory. 

Use the same installation directory for all three products. 

Do NOT create subdirectories for each product—the installation script does that 
for you.. 

2.3. Extracting the This section steps through the procedure for retrieving the installation script from 

Installation Script the release tape. 

First, insert one of the release tapes into your tape drive. If you have any ques¬ 
tions about how to load a tape on your tape drive, see the subsystems chapter in 
the Hardware Installation Manual for your machine. 

Tape Devices Where you see the word tape in the subsequent illustrations of typing commands 

to the system, substitute one of stO, mtO, or arO, for tape, depending on the 
format of the tape. Table 2-2 below shows you which tape name to use for tape. 

Table 2-2 Tape Device Names 


Name 

Device 

stO 

SCSI 14-inch tape controller 

arO 

Archive Vi-inch tape (older systems) 

mtO 

Nine-track V^-inch magnetic tape (1600 bpi) 


If you are using a remote tape drive, skip to the section Using a Remote Tape 
Drive. 
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Using a Local Tape Drive Skip to the section that matches your tape configuration: Local V 4 -inch Drive or 

Local Vi-inch Drive. 

Local V 4 -inch Drive Rewind the tape and skip over the copyright mark by typing the following two 

commands: 



Use tar(l) to extract the install script from the tape: 

/-s 

# tar xvbpf 126 /d&v/nxtape 
(.. .messagepom tar...) 

V_/ 

Skip to the section entitled Run the Installation Script below, to start the installa¬ 
tion. 

Local Vz-inch Drive Rewind the tape and skip over the copyright mark by typing the following two 

commands: 


r 

# tat — f / 6 B’v/iirt(tp 0 

# mt -t /detv^/nxiape ts£ 1 

'V 

Use tar(l) to extract the install script from the tape: 


# %aiX x.vp£ /tlev/tixtape 


{,..message pom tar...} 




_ 

.. 


Skip to the section entitled Run the Installation Script below, to start the installa¬ 
tion. 


Using a Remote Tape Drive You must be supemser (root) to run these commands, so, note that the hostname 

of the local machine (where you are typing commands) must be in the remote 
machine’s / . rhost s file to avoid permission problems. In addition, if you are 
not running the yellow pages (YP), each machine must have an entry (name and 
Internet address) for the other in its /etc/hosts file. 


Device abbreviations are sto, mto, 
or arO, for tape, depending on the 
format of the tape. See table 2-2— 
Tape Device Names for details. 


In the following machine dialogs, remember to replace tape with the appropriate 
device abbreviation for the remote tape drive you are using. 

You must also replace remotejiost with the hostname of the machine to which 
this tape drive is attached. 

Skip to the section that matches your tape configuration: Remote ‘A-inch Drive or 
Remote Vz-inch Drive. 
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Remote V4-inch Drive Rewind the tape and skip over the copyright mark by typing the following two 

commands: 

f -^-\ 

# rsh remoteJtoSt "mt -£ /d&v/nrtape rew” 

# rsh remote host "rot ~£ /dev/nr/t^w fs£ 1” 

N_—_______^ 

Use tar(l) to extract the install script from the tape: 

( --\ 

# rsh remotejiost "dd i£=/dev/nrrape b8=20b" | tar xvpB£ - 

(.. .message from tar...) 


Skip to the section entitled Run the Installation Script below, to start the installa¬ 
tion. 

Remote Vi-inch Drive Rewind the tape and skip over the copyright mark by typing the following two 

commands: 


# rsh remotejiost "mt -f /^■v/nxtape rew" 

# rah remote host "mt /6&v/T>.xtape £s£ 1" 


Use tar(l) to extract the install script from the tape: 

# rsh remotejiost "dd i£=/dev/nrto/>e bs=20b" | tar xvpBf - 
f.. .messagefrom tar. 

- ———^_____ .j 


Run the Installation Script 


Product files will be installed in the installation directory that you created if you 
followed the instructions in section 2.2 —Getting Started —^previously. 

Use the pwd (print working directory) command and make sure that you are stiU 
in the correct directory. 


Use the install script to install the release files. Type the command 
install_unbundled. You will see the following greeting: 

# install^unbxiA<Jled 

t^elcome to the STAGS installation script! 

When responding to questions^ please type one 
of the available options exactly as given. 

V—--—--------------^ 


The installation 


script asks you for the information that it needs to proceed. 
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C 

Remote or Local Installation 


Remote machine name 


Tell the script whether you are doing a local or remote installation. 

. _ . . ' . 

Are you doing a local or remote installation tl^r]? 

-:- ■ _ _ _ 


If you are doing a local installation, the script will skip this step. 

If you are doing a remote installation, enter the name of the remote machine. 



Enter the Name of the Tape 
Drive 


Confirming the Installation 

c 



The next request is for the name of your tape drive. The script will display three 
options. 

-- 

Please entor the tape device name {stO,arO,mtO]; tape 


Enter the name of your tape drive in the format shown in the prompt line. If it is 
not exactly one of the options shown, the script will continue to ask you until you 
type in one of the three valid choices. 

Once the script has all the information from you that it needs to complete the 
install it will ask you to confirm the installation with a message similar to this 
one: 

Remotely produciname from hostjume in 

directoryname from t£^e. DK? tY/n] 

V---^^. 

If you type ‘y’, the script wiU then extract the product files from the tape. 

After all of the product binaries and fonts are extracted from the release tape, the 
script will check for the existence of major directories as a quick verification of 
the installation. Here is an example of what you will see on the screen: 

Checking disk space availability... 

Installing productname fiias from the tape^.. 

messages from tar 

Installing snnview font set^.- 
{ ...messages from tar ..s) 

Installing productname fonts_ 

{ ...^ messages from tar 
Verifying the installation*.. 
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Completing the Installation 


The script displays the following message when the installation is complete. 
Installation of productname complete. 

^ _ > 


2.4. Install the Other Two 
Products 


Run install_unbundled again for the other two product tapes, without 
changing directories. 

The installation script places the release files in several different directories, as 
you can see by typing the Is command in the directory where you installed the 
STAGE products. Here is an example of a directory listing where aU three pro¬ 
ducts have been installed. 


( - 

# Is -F 





bin/ 

fonts/ 

sundraw/ 

sunwrite/ 


demo/ 

# 

install^ 

^unbundled* 

sunpaint/ 






___> 


2.5. Installation Script 

Problems and What To 
Do About Them 

Table 2-3 


This section lists possible error messages from the installation script, and what to 
do when they occur. 

Error Messages from Installation Script 


You must be root to install productname. 
Please log in as root and try again. 
Exiting.... 


Occurs if you did not log in as the super-user. 
Run the UNIX command su, and restart the 
installation script. 


Assuming local installation. This message will appear if you do not type an 

‘1’, or an when the script asks you about 
remote or local installations. The script will 
proceed to do a local installation. 


Invalid device name tape. Appears if you mistype the tape drive device 

name. The script will continue to prompt you for 
the device name until you type in a valid 
response. The valid choices are listed in Table 
2-2, Tape Device Names. 


The device tape does not exit on hostname. 
Try again. Exiting.... 


You will see this message if the tape device does 
not live on your system. Verify the name of 
your tape drive, and make sure that you are 
logged in to the machine that owns the device 
(this is most likely the server for your network). 
Start the script again. 
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Table 2-3 Error Messages from Installation Script — Continued 

Can't find product identification file. 

Enter product name: SunWrite, SunPaint, SunDraw [w, p, d]: 

Occurs, if for some reason the product ID file 
was not on the tape, or accidentally got removed 
from the system during the installation process. 
Type a one-character response to the question 
and the script will proceed normally. 

Invalid product name productjiame, 

If you received the previous error message, and 
if you mistype the product name, you will see 
this message. The script will continue to prompt 
you for the product name until you type in a 
valid response. 

Can't install in /. Exiting. 

Appears if your current working directory is /. 
Change directories to the installation directory 
with the cd command, and restart the script. 

productjname is already installed. Overwrite [y,n]? 

You will see this message if the product direc¬ 
tory already exists. If you type ‘y’, the script 
will overwrite whatever is already there. Other¬ 
wise, it will exit. 

Installation stopped by user request. Exiting... 

If at any point the script asks you to confirm the 
installation and you reply ‘n’, it will display this 
message, and exit without proceeding with the 
installation. 

You do not have write permissions in the install 
directory directoryjtame, Please change the permissions 
on this directory (or change the installation directory) 
and try again. 

Check your directory with the pwd command to 
make sure that you are in the right directory. 
Also, check the write permissions and make sure 
that you have not mounted the installation direc¬ 
tory on a read-only file system. Once you have a 
directory in which you can write, restart the 
script. 

productncune requires xxxxx Mbytes of disk space and there 
are only yyyyy Mbytes available in the current 
filesystem. Please make space, or rerun this script 
with a new install directory name. 

Exiting.... 

Try to find a file system with enough space, or 
remove some unnecessary files to make space, 
and start the script again. 

<#sun 
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Table 2-3 Error Messages from Installation Script — Continued 


Tape rewind failed. Exiting... 

Can't space forward on tape. Exiting... 
File extraction failed. Exiting... 


If at any time during the installation, any of the 
mt or tar commands fail, you will see one of 
three error messages listed at left. You should 
remove any of the files already extracted, and try 
the procedure again. If it fails again, you may 
have a bad tape. Call your local support guru (in 
theU.S. 800-USA-4SUN). 


productname directory not found. Installation failed, 
fonts/sunview directory not found. Installation failed. 
fonts/productname directory not found. Installation failed, 
bin directory not found. Installation failed. 
domo/productname directory not found. Installation failed. 
Installation failed. Exiting... 


Any of these messages will appear if for some 
reason, one of the major installation directories 
is missing. Remove all the existing directories 
and try the install procedure again. If it fails 
again, you may have a bad tape. Call your local 
support guru (in the U.S. 800-USA-4SUN). 



Revision A of 25 December 1988 



Client Setup Procedure 


Client Setup Procedure. 

3.1. Mount the Software. 

3.2. Install the Password. 

3.3. Choose an Installation Strategy 

3.4. Create Links. 

3.5. Create /etc/sundesk . 













Client Setup Procedure 


3.1. Mount the Software 


Create a Directory for the 
Mount Point 


Mount the Installation 
Directory 


This chapter takes you through the client setup procedme step-by-step. Later in 
this chapter you need to decide on an installation strategy. One way is to set up 
the client machines so that the end users will have to do nothing but type the 
name of the desired application. The other strategy requires that the end users 
modify their shell environment. 

You must mount the installation directory on the server machine to a mount point 
on the client. Again, we recommend that you use the mount point 
/usr/sundesk. You will want to edit the client’s /etc/f stab file and 
make the mount automatic after every reboot. See the System and Network 
Administration manual for more details about moimting file systems, and the 
/etc/f stab file. But for now, do a fast mount. Here’s an example assuming 
that you are using /usr/sundesk. First, create the moimt point directory. 



Then, do the mount. Make sure you do a hard mount by using the -o hard 
option as shown. 


# /etc/mount -o hard :/usr/sundesk /usr/sundesk 

V____/ 


3.2. Install the Password See Chapter 6— Installing the stage Password —^for the full details of this step. 

3.3. Choose an Installation If you want any user, on any licensed machine to be able to start up the products 

Strategy without modifying their environment, you must foUow the next two steps in this 

chapter for each client machine. However, if your users are capable of modify¬ 
ing their environments, you can skip the remainder of the chapter, and have them 
follow the instructions in Chapter A—Installing a User. 
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3.4. Create Links If you create these links your users may not need to modify their path variables. 

Create links from the installation’s bin directory to a more commonly used bin 
directory that most users already have in their default path, /usr/bin or 
/usr/local/bin will probably work. For example, you have a directory 
called /usr/bin that every client machine in your company mounts, and you 
have installed the STAGE products in /usr/sundesk/bin. You would 
make the links like this: 


Making Links to the Products 



NOTE Make sure that when making the links you use relative pathnames. 


NOTE If your client users are using the C Shell, they will need to type a rehash com¬ 
mand if they do not wish to log out and log in again. 

3.5. Create The installation script creates a file called / et c/ sundesk on the server 

/ etc/ sundesk machine. It contains one line: the full path name of the installation directory. 

This file eliminates the need for each user to set a SUNDESK environment vari¬ 
able. If the user does not have SUNDESK set, then the STAGE products look in 
this file for a pointer to its start-up files, and its fonts. Look at the file with the 
cat command to view the format: 

# cat /etc/sundesk 

/usr/sundesk 

lilll|i|iiiiiii|i|||M 


If the mount point on the client is different than the pathname on the server, 
create /etc/sundesk with your favorite editor and supply the correct direc¬ 
tory name. 


Copying /etc/sundesk to 
Clients 


However, if the path names are the same, you can just copy the file fiom the 
server to the client machine using the rep command: 



NOTE fi/rep displays any system errorsyour . rhosts file may be set up incorrectly. 
See the notes about the . rho st s file in 2 3.2—Using a Remote Tape Drive 

NOTE On heterogeneous systems be careful when creating tfie/etc/sundesk file for 
your client machines. The path to /usr on the server machine may really be 
/usr .mc68010 . Verify the mount point’s ’real name’ before creating the file. 
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Installing a User... 

4.1. User Installation Summary. 

4.2. Changing Your Path. 

4.3. Setting the SUNDESK Environment Variable 










Installing a User 


4.1. User Installation 
Summary 


4.2. Changing Your Path 


C Shell Users 


This section describes how to modify your environment to enable you to run the 
STAGE products. 

If the systems administrator did not set up the client machines as described in 
Chapter 3 —Client Setup Procedure, you should modify your working environ¬ 
ment 

You can teU if your system administrator has set up the client machine by run¬ 
ning one of the three products. If the product can not find its fonts then you must 
set up your own user environment. (Each product will display an error message 
if it can’t locate its fonts.) Otherwise, skip this chapter and go on to the next. 

There are only two environment modifications that you must make. The first is 
to modify your path variable, so that the shell can find the STAGE products. 


( . ...— 

% set path»($path installjUrectory/hi.n} 

% rehash 



_ -j 


Bourne Shell Users . . 

% export P'AVfi 

^ .—. ‘ . . . . ^ 

4.3. Setting the SUNDESK Each user must set an environment variable which enables STAGE products to 
Environment Variable find their fonts and other support files. 


C Shell Users 


/ --—...——^ 


% setenv SUNDESK install directory 




. 

.: 


Bourne Shell Users 



sun 
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% SaKDZSK=nnstaUjSrectory 
% eacpott SUNDESK 

<_:_ J 


NOTE Both the path modification and the environment variable setup should be added 
to your . login file (or .profile file for the Bourne Shell) so that they are 
automatically issued during login. 

Read Chapter 5 —Administration and User Options —for the administration 
instructions on how to start SunWrite, SunPaint, and SunDraw and specify user 
options. 

If you require a password see 6 —Installing the stage Password. 
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Administration and User Options 


This chapter explains swap space requirements and individual startup file options 
you can change. 


5.1. System Swap Space SunWrite, SunPaint, and SunDraw are three application programs that mn in the 

Suntools environment. 

If you try to mn aU three applications simultaneously, you will need at least four 
(4) megabytes of swap space more than what you are currently using—SunPaint: 
l.OM; SimWrite: 2.0M; SunDraw: l.OM. 

This means that to mn the SunView window environment, plus STAGE products, 
plus actually do any useful work such as creating a complex document using 
SunWrite or a complex drawing using SunDraw, you should have a minimum of 
eight megabytes of swap, and 16 megabytes is recommended. 

5.2. User-Defined Options You can customize the startup state of any of STAGE product by editing its 

startup file. 

There are example startup files for each product in the installation directory. 
These example startup files are also the default files that the STAGE products use, 
if you have not set one up yourself. 

Changes you make to a startup file will not take effect on any mnning programs. 
You must quit, and restart the program. 


Copying the Default Startup 
Files 

% op /usr/sundesk/sunwrite/dot.stiftwrite .sunwrito 
% op /usr/sundesk/sunpaint/dot.sunpaint .sunpaxnt 
% cp /usr/sundesk/sundraw/dot.aundraw .sundraw 

-— --- ^ 


If STAGE was installed in /usr/sundesk then you can copy over the three 
startup files with the following three commands., Copy them into your home 
directory. 
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5.3. Starting Up SunWrite, You must have the SunView user interface environment (the window system) 
SunPaint, or SunDraw running b^ore you can use any of the STAGE products. 

First, start up the SunView environment by typing sunt ooIs on your worksta¬ 
tion (these tools run in the SunView window environment). 

If you are not familiar with the SunView window environment, see the SunView 
1 Beginner’s Guide. 

Customizing Your To make STAGE tools more convenient to start up, you can customize your root- 

. rootmenu menu and make these products available as a selection from the desktop. To 

modify your rootmenu, use your favorite editor to add the following entries to the 
. rootmenu file in your home directory. Again, assume an installation direc¬ 
tory of /usr/sundesk. 

-_____ ^ 

"SunWrite" /usr/sundesk/bin/sunwrite 
"StmPaint" /usr/sundesk/bin/sunpaint 
"SunDraw" /usr/sundesk/bin/sundraw 


Starting STAGE Programs 
from a Shell Window 


To start up SunWrite, type the following command in a sheUtool window: 


r 

% sunwrite ^ 

- V 


J 

To Start up SunPaint, type the following command in a sheUtool window: 

% sunpaint & 

tl] 4130 



J 

To start up SimDraw, type the foUowing command in a sheUtool window: 


'' 

% sundraw S 
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Installing the STAGE Password 


NOTE SKIP THIS CHAPTER IF YOU DO NOT REQUIRE PASSWORDS. 

ONLY SITES IN THE UNITED STATES OF AMERICA REQUIRE PASS¬ 
WORDS. SITES OUTSIDE OF THE UNITED STATES OF AMERICA DO 
NOT REQUIRE PASSWORDS. 

This chapter tells you how to obtain and install the passwords you need to use 
STAGE products. 

Each client machine needs three passwords—one for each product. 

NOTE If you start up one of the STAGE products, and you have not installed the pass¬ 

word for that product, it will run as a demonstration application, and you will 
not be able to save your work! 

You should read this entire section before installing the password. 


6.1. Who Needs a 
Password? 


You need a password if: 

□ You have just installed STAGE for the first time, or, 

□ If you want to run STAGE on a different machine from the one you have 
been using. 

Note that STAGE products determine the machine’s identity by reading its 
ho St id number from an integrated circuit (IC) inside the machine. If this IC is 
changed, STAGE will not recognize the old password. The same thing will hap¬ 
pen if the CPU board on which the IC resides has been changed (unless, the IC is 
removed from the old board and inserted into the new one). 


Displaying Your Host ID 


You can display your machine’s host id with the hostid(l) command, as fol¬ 
lows: 


----- 

% host id type the host id command 

1200222b system displays the host ID for your machine 

liiiiiiiiiiiiiiiiliiiiii® 

—— --- > 


If your machine undergoes service and your password no longer works, it is 
probably because the hostid IC has been changed. Tell your service department 
that you want the old hostid IC put back into your machine. If this is not possi¬ 
ble, contact Sun for a new password. 
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6.2. Installing A Password To install the password on your machine, you must execute the 

installjiassword program. The install_password program pro¬ 
vides instructions and asks you for information. Before executing the installation 
program, you must collect some information. 

In order to get your password to run STAGE programs, you need to know your 
sales order number and what licenses you have purchased. Be sure to collect this 
infonnation b^ore calling the Sun hotline. The install_j)assword program 
will teU you when you are ready to place the phone call. 

Sales Order Number The install_password program will ask you to enter your sales order 

number. The Sun hotline operator will need to know this number in order to give 
you a password. 

Right-to-Use License You may obtain only one password per right-to-use license. 

To run STAGE products on more than one machine, you must buy additional 
licenses from your Sun sales representative and then install a password for each 
machine. 


6.3. Gather the Necessary 
Information 


6.4. Run the Installation 
Program 


On the machine on which you wish to run STAGE products, become superuser 
(root) and start the install_password program. If the software was 
installed or mounted under /usr/sundesk, then the password installation 
program is in the /usr/sundesk/bin directory, and can be executed with the 
following command. First, run the program for SunWrite. 
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You Purchased a STAGE 
License 


Enter a y (if you purchased a SunWrite license). This message appears: 


This program will install a SunWrite password. 

When you call Sun to obtain the password, the operator 
will ask you for: 

the product name/ 
your workstation's hostid, 
your sales order number^ and 
your name. 

This program will supply the product name and the workstation 
hostid. Your sales order number may be found attached to the 
shipment♦ 

Enter your sales order number here: 

-- > 


Enter your sales order number and you will see: 




.\ 

Call Sun at (800) 872-4786 

When the operator answers, tell 


him or her that yo'u wish a 

password for SunWrite* 


Tell the operator: 



Product Name; 

SunWrite 


Rost id: 

your hostid will appear here 


Sales order nttmbert 

your sales order number will appear here 


Type Ih the SunWrite password below as the operator reads it 


to you. 



SunWrite password: 



V. . 


_ y 


Call for Your Password Call Sun at the number provided. When the operator answers, tell him or her that 

you want a password for SunWrite and give the operator the rest of the informa¬ 
tion when asked. 

If your telephone is near your workstation, enter the SunWrite password at your 
workstation as the operator reads it to you. 

NOTE Be sure the password is accepted by the install program before terminating your 
call to the Sun hotline. 

If your telephone is not near your workstation, be sure to have a paper and pencil 
ready to record the password as the operator reads it to you. Be sure to verify the 
password before you hang up. 

The password will be a string of letters and numbers that will look something 
like this: 


glxi y2wz 


The letters in the password can be entered as uppercase or lowercase. Spaces are 
permitted between characters, but are not necessary. Be sure you distinguish 
between the number zero and the letter o (oh) and between the number one and 
the letters i and 1 (ell). 
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NOTE Be careful not to enter any extra characters (especially spaces) as the first char¬ 

acter of your password. 

When you have typed in the correct password you will see: 

SunWrite password installed on onion. 

Password installation complete. 

V_— J 

Before terminating your call to the Sun Hotline, run the password installation 
programs for SunPaint, install_sunpaint_jpassword, and for SunDraw, 
install_sundraw_password. 

NOTE A password that works on your machine will not work on another machine. 

You are now ready to run all three STAGE products! 


6.5, Password Installation This section lists possible error messages from the password installation pro- 
Problems and What To gram, and what to do when they occur. 

Do 

Table 6-1 Error Messages from Password Installation 


*** Can't open password file: /etc/licenses: Permission denied OCCUTS if you forgOt tO log in as the Supcr- 
Run this program as root. user. Run the UNIX command su, and res¬ 

tart the password installation program. 


Password for SunWrite is already installed on 
onion. 


This message will be displayed if your 
machine is already authorized to run 
SunWrite. If you get this message, you do 
not need to install a password. Go ahead 
and start using the SunWrite. 


Contact your Sun sales rep. to purchase a SunWrite license. This message is displayed if yOU enter an 

‘n’ when the installation program asks you 
if you have purchased a license. If you do 
not have the licenses to run the STAGE pro¬ 
ducts, the program will terminate. You must 
obtain the appropriate licenses before you 
can install the password. 
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Table 6-1 Error Messages from Password Installation — Continued 


★★★Invalid password, try again. 


Tell the operator: 

Product Name: SunWrite 

Host id: your hostid will appear here 

Sales order number: your sales order number will appear here 


Retype the password to make sure that you 
did not make a typographical error. If it is 
still incorrect and you are still on the tele¬ 
phone, ask the Sun operator to repeat the 
password. Otherwise, you must call again to 
get the correct password. 


Type in the SunWrite password below as the operator reads it 
to you. 


SunWrite password: 


6.6. Installing Passwords If you have many machines on which you wish to install these products, instal- 

‘by Hand’ ling the passwords ‘by hand’ would certainly prove to be less time consuming. 

Before calling the Sun operator, have all of the machines’ hostids, and their 
corresponding licenses ready to read to the operator. 

Create a file on the server machine called /etc/licenses. This file is actu¬ 
ally used by many other programs as well, so it may already exist on your sys¬ 
tem. If this is the case, simply edit the file that’s already there, being careful not 
to destroy or lose any of its contents. 


SunWrite / 

13000289 

e21db3yp 

\ y ^ 

Name of 
Application 

Host ID 

Password 


Each line in the /etc/licenses file represents one product’s license. Each 
of these lines contain the product name, the hostid of the machine for which it is 
licensed, and the password. Use the ‘/’ character to separate the product name 
and the hostid, and the ‘’ character between the hostid and the password. Here 
is an example /etc/licenses file. 

# cat /etc/licenses 

SunWrite/13000289 :e21ctb3yp 

SunTrac-1,0/13000289;8s86tratv 

SunSimplify-1.0/13000289:obaw 15kjo38 91mf 1 

lliliilii 

V. . ..!- 


Onct you have created the /etc/licenses file on the server, and it contains 
the passwords for all of your machines, you can download this file to all of the 
clients. The products can then find the password for the client machine in the 
/etc/licenses file when executed. You can, logged in as root, use rep to 
copy the file to all of the clients. In the following command substitute the server 
machine’s name for server_name, and each of the client machines’ names in turn 
for clientjiame. 

---- 

# rep jerver namc.Vetc/licanses /etc/licenses 
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NOTE If rep displays any system errors your . rhost s file may be set up incorrectly. 
See the notes about the . rhost s file in 2.3,2—Using a Remote Tape Drive 



Revision A of 25 December 1988 



SunWrite “dot” File 


Sun Write “dot” File 










SunWrite “dot” File 


This file, . sunwrite, is part of the SunWrite distribution tape. You can edit it to customize your SunWrite 
environment. This file is read each time you start Sun Write, therefore, the changes you make to . sunwr.ite , will 
not affect any running copies of SunWrite. You must quit SunWrite and start it again. 


If your system administrator installed the STAGE products in /usr/sundesk, the default file can be found in 
/usr/sundesk/sunwrite/dot.sunwrite. 
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# 



200 - for "Twice Actual Size" 

# DEFAULTRES 

int 

300 

DEFAULTRES controls the default 

# 



resolution of the graphics that are 

# 



imported into frames. This value is 

# 



indicated in the "Resolution" field 

# 



in the Frame Properties window. 

# 



DEFAULTRES can range from 10 through 

# 



9999. 

# UNITS 

string 

INCHES 

UNITS controls the default display unit 

# 



for rulers and Grids in SunWrite. UNITS 

# 



is also reflected in the units used in 

# 



the "New Document Settings" window. 

# 



Valid values are one of the following: 

# 



INCHES 

# 



DECIMALINCHES 

# 



CENTIMETERS 

# 



MILLIMETERS 

# 



PICAS 

# 



POINTS 

# XGRIDDIVISIONS 

float 

0.25 

XGRIDDIVISIONS controls the default 

# 



Horizontal grid mark spacing in current 

# 



units (see UNITS). The default value 

# 



appears in the "Grid/Ruler Setting" 

# 



window. 

# YGRIDDIVISIONS 

float 

0.25 

YGRIDDIVISIONS controls the default 

# 



Vertical grid mark spacing in current 

# 



units (see UNITS). The default value 

# 



appears in the "Grid/Ruler Setting" 

# 



window. 

# PRINTER 

string 

Iw 

PRINTER controls the default printer 

# 



name where all SunWrite documents 

# 



are routed to. The default value 

# 



appears in the "Printer Setting" window. 

# HEIGHT 

float 

11.0 

HEIGHT controls the height of the 

# 



default SunWrite page (in UNITS) . 

# 



Values (in inches) for some standard 

# 



page types are: 

# 



U.S Letter - 11.0 

# 



U.S. Legal - 14.0 

# 



International A4 - 11.69 

# 



International B5 - 9.84 

# 



Notes - 8.5 

# WIDTH 

float 

8.5 

WIDTH controls the width of the default 

# 



SunWrite page (in UNITS). 

# 



Values (in inches) for some standard 

# 



page types are: 

# 



U.S Letter - 8.5 

# 



U.S. Legal - 8.5 

# 



International A4 •“ 8.27 

# 



International B5 - 6.93 

# 



Notes - 7.0 

IT 

# TOPMARGIN 

float 

0.75 

TOPMARGIN controls the blank space 
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f# 



from the top of the page to where 

'' 

# 



first line of text can be typed 


# 



(in UNITS). This value is reflected 


# 



in the Top Margin field in New Document 


# 



Settings window 


# OUTSIDEMARGIN 

float 

0.75 

OUTSIDEMARGIN controls the blank space 


# 



from the last character on a line to the 


# 



outside boundary of a page (in UNITS). 


# 



This value is reflected in the 


# 



Outside Margin field in New Document 


# 



Settings window 


# INSIDEMARGIN 

float 

1.0 

INSIDEMARGIN controls the blank space 


# 



from the inside boundary of a page to 


# 



the first character of text (in UNITS). 


# 



This value is reflected in the 


# 



Inside Margin field in New Document 


# 



Settings window 


# BOTTOMMARGIN 

float 

0.75 

BOTTOMMARGIN controls the blank space 


# 



from the last line of text to the 


# 



bottom of the page (in UNITS). This 


# 



value is reflected in the Bottom Margin 


# 



field in New Document Settings window. 


# 

# MIDDLEWHITESPACE 

float 

0.25 

Middle White Space (in UNITS) 


# TOPWHITESPACE 

float 

0.25 

Top White Space (in UNITS) 


# BOTTOMWHITESPACE 

float 

0.25 

Bottom White Space (in UNITS) 


# LEFTWHITESPACE 

float 

0.25 

Left White Space (in UNITS) 


# RIGHTWHITESPACE 

float 

0.25 

Right White Space (UNITS) 


# 



These five keywords control the amount 


# 



of white space between the edge of a 


# 



SunWrite page and the SunWrite canvas 


# 

# STARTINGPAGE 

int 

1 

STARTINGPAGE controls the first page 


# 



number of a default SunWrite document. 


# 



This value is reflected in the 


# 



"First Page" field in the New Document 


# 



Settings window. 


# NUMBEROFCOLUMNS 

int 

1 

NUMBEROFCOLUMNS controls the number 


# 



of columns in a default SunWrite 


# 



page. This value is reflected in 


# 



the Column Properties window. 


# FONTNAME 

string timesroman 



# 



FONTNAME controls the font style of the 


# 



default SunWrite text. This value 


# 



is reflected in the "Font" field in 


# 



the Text Properties window. 


# FONTSIZE 

int 

12 

FONTSIZE controls the pointsize of 


# 



the default SunWrite text. This value 


# 



is reflected in the "Size" field in the 


# 



Text Properties window 


# FONTCOLOR 

int 

0 

FONTCOLOR controls the text color of 


# 



the default SunWrite text. FONTCOLOR 


# 

\_ 



value can range from 0 (for white) 
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# FONTSTYLE 

# 


string 


to 100 (black) . This value is reflected 
in the "Text Color” field in the Extra 
Text Properties window. 

FONTSTYLE controls the font face of the 
default SunWrite text. This value is 
reflected in the "Face" field in 
Text Properties window. 

Valid values are; 

MEDIUM 

ITALIC 


# FONTSCRIPT 

# 


string NORMAL 


BOLDITALIC 

FONTSCRIPT controls the position of the 
default SunWrite text. This value is 
reflected in the "Position" field 
in Text Properties window. Valid values 


# FONTUNDERLINE 

# 


string NORMAL 


# FONTCASE 

# 


string NORMAL 


SUPERSCRIPT 

SUBSCRIPT 

NORMAL 

FONTUNDERLINE controls the underlining 
of the default SunWrite text. This 
value is reflected in the "Position" 
field in Text Properties window. Valid 
values are: 

NORMAL - for no underline 

UNDERLINE 

DOUBLEUNDERLINE 

FONTCASE controls the case type of the 
default SunWrite text. This is 
reflected in the "Case" field in Text 
Properties Window. Valid values are: 
NORMAL “ for Mixed Case 
LOWERCASE 
UPPERCASE 
SMALLCAPS 


# JUSTIFICATION 

# 


string RAGGEDRIGHT 


# LEADING 

# 


# LINEWIDTH 

# 


float 


JUSTIFICATION controls the justification 
of a default text paragraph. This is 
reflected in the "Justify" field within 
the Paragraph Options of the Text 
Properties window. Valid values are: 
RAGGEDRIGHT - for Right Justification 
RAGGEDLEFT - for Left Justification 
CENTER - for Center justification 
JUSTIFY- for Full Justification 
LEADING controls the % leading factor 
used in SunWrite paragraphs. This is 
reflected in the "Leading Expansion" 
field in the Extra Text Properties 
window 

LINEWIDTH controls the width of the 
lines (in UNITS) that are used to 
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r 

I * 



create frames in SunWrite. This is 

-\ 

# 



reflected in the "Line Width" field 


# 



in the Frame Properties window. 


# HYPHENATION 

int 

1 

HYPHENATION controls the auto- 


# 



hyphenation of SunWrite text. This is 


# 



reflected in the "Auto Hyphenation" 


# 



field in Extra Text Properties 


# 



window. Valid value are: 


# 



1 - Auto Hyphenation is ON 


# 



0 - Auto Hyphenation is OFF 


# KERNING 

int 

0 

KERNING controls the Auto Kerning 


# 



of SunWrite text. This is 


# 



reflected in the "Auto Kerning" 


# 



field in Extra Text Properties 


# 



window. Valid value are: 


# 



1 - Auto Kerning is ON 


# 



0 - Auto Kerning is OFF 


# SPREAD 

int 

0 

SPREAD controls the number of pages 


# 



that can be viewed simultaneously 


# 



in SunWrite. Valid values are: 


# 



1 - View Two Pages 


# 



0 - View One Page 


# 

# HOLERS 

int 

0 

RULERS controls the display of 


# 



horizontal and vertical rulers 


# 



in SunWrite. Valid values are: 


# 



1 - Display Rulers is ON 


# 



0 - Display Rulers is OFF 


# SCALEGRAPHIC 

int 

0 

SCALEGRAPHIC controls the scaling of 


# 



graphics imported into SunWrite. This is 


# 



reflected in the "Graphics Option" 


# 



field in Frame Properties window. Valid 


# 



values are: 


# 



1 - Graphics scaled when imported 


# 



into SunWrite frame 


# 



0 - Graphics not scaled when imported 


# 



into SunWrite frame 


# GRIDSVISIBLE 

int 

0 

GRIDVISIBLE controls the display of 


# 



grids on a default SunWrite page. 


# 



Valid values are: 


# 



1 - Grid display is ON 


# 



0 - Grid display is OFF 


# TEMPLATEVISIBLE 

int 

1 

TEMPLATEVISIBLE controls the display of 


# 



templates on a default SunWrite page. 


# 



Valid values are: 


# 



1 - Template display is ON 


# 



0 - Template display is OFF 


# GUIDESVISIBLE 

int 

0 

GUIDESVISIBLE controls the display of 


# 



guides on a default SunWrite page. 


# 



Valid values are: 


# 



1 - Guides display is ON 


# 



0 - Guides display is OFF 


# DOUBLESIDED 

int 

0 

DOUBLESIDED controls the type of 
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# 

# 

# 

# 

# 


# SNAPTOGRID 

# 

# 

# 

# 

# SNAPTOGUIDES 

# 

# 

# 

# 

# FONTS 

# 

# 

# 

# 

# PAGESTYLE 

# 

# CONTAINCLIPFILE 

# 

# 

# 

# PAGECLIPFILE 

# 

# 

# 

# GRT^HICSCLIPFILE 

# 

# 

# 

# 

# 

# 

# 

# 


int 

int 

string 

string 

string 

string 

string 


# Let's set some variables now. 


fonts $SUNDESK/fonts 
fontsize 12 
zoom 100 
RULERS 1 

GRAPHICSCLIPFILE /tmp/sundesk 

# 

middlewhitespace .125 
topwhitespace .125 
bottomwhitespace .125 
leftwhitespace .125 
rightwhitespace .125 


the default sunwrite document. 

This value is reflected in the 
"Document" field in New Document 

Settings window. Valid values are: 

1 Double Sided Document 
0 “ Single Sided Document 
1 SNAPTOGRID controls the positioning 

of the graphics imported into SunWrite 
frames. Valid values are: 

1 - Snap to Grid is set to ON. 

0 - Snap to Grid is set to OFF 

0 SNAPTOGUIDES controls the positioning 

of the graphics imported into SunWrite 
frames. Valid values are: 

1 “ Snap to Guides is set to ON. 

0 - Snap to Guides is set to OFF 

FONTS controls the absolute path 
to the directory where SunWrite 
fonts are installed. The default 
value of FONTS is attached by the 
SunWrite Install Process. 

"" PAGESTYLE controls the default style 

guide for a SunWrite document. 

/tmp/sunwrite.frame.clip 

CONTAINCLIPFILE controls the file that 
is used to place frames when frames 
are cut and pasted. 

/tmp/sunwrite.page.clip 

PAGECLIPFILE controls the file that 
is used to place pages when pages 
are cut and pasted (using Edit Pages). 
/tmp/sundesk_clipboard 

GRAPHICSCLIPFILE controls the file 
that is used to performs the cut, 
paste and other edit operations 
between SunWrite and SunDraw and 
SunPaint. If this is changed, make 
sure it is changed for SunDraw and 
SunPaint. 


clipboard 


W 
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This file, . sunpaint, is part of the SunPaint distribution tape. You can edit it to customize your SunPaint environ¬ 
ment. This file is read each time you start SunPaint, therefore, the changes you make to . sunpaint , wiU not affect 
any running copies of SimPaint You must quit SunPaint and start it again. 


If your system administrator installed the STAGE products in /usr/sundesk, the default file can be found in 
/usr/sundesk/sunpaint/dot.sunpaint. 
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^ # CANVAS_SIZE 

int, int 

CANVAS_SIZE controls the size of the 

N 

# 


default canvas when SunPaint in invoked. 


# 


It is set as x,y where x is the width of 


# 


the canvas in pixels and y is the height 


# 


of the canvas in pixels. CANVAS_SIZE 


# 


value is reflected in the Window Header 


# 


area of SunPaint 


# CLIPBOARD 

string 

CLIPBOARD controls the filename 


# 


which is used for all edit 


# 


operations in SunPaint. The 


# 


filename should be the same 


# 


as GRAPHICSCLIPFILE in 


# 


.sunwrite file if you want to 


# 


cut and paste across SunPaint and 


# 


and SunWrite. 


# F0NT_LIST 

string 

F0NT_LIST controls the absolute 


# 


path to the directory where 


# 


SunPaint fonts are installed. 


# 


The default value is attached 


# 


by the SunPaint Install Process. 


# MARKERS 

int 

MARKERS controls a visual guide 


# 


that displays markers on the canvas 


# 


as an aid in drawing geometric 


# 


figures. Valid values are : 


# 


0 - Markers are off 


# 


1 - Markers are on (Default). 


# RASTER_TYPE 


RASTER_TYPE controls the 


# 


type of raster that is rendered 


# 


in SunPaint. Valid values are; 


# 


1 - RT_STANDARD (standard raster type) 


# 


2 “ RT_BYTE_ENCODED (byte encoded raster 


# 


type). Default is 2 


# PRINTER 

string 

PRINTER specifies the default printer. 


# 


The default value appears in the printer 


# 

it 


settings window. 


## Current Values 



## 

# 




CANVAS_LIMIT 

1600, 1280 



CANVASES IZE 

640, 480 



CLIPBOARD 

"/tmp/sundesk_ 

clipboard” 


F0NT_LIST 

"$SONDESK/font 

s/sunpaint/fontlist" 


MARKERS 

1 



RASTER__TYPE 

2 



V_ 



j 
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SunDraw “dot” File 


This file, . sundraw, is part of the SunDraw distribution tape. You can edit it to customize your SunDraw environ¬ 
ment. This file is read each time you start SunDraw, therefore, the changes you make to . sundraw, will not affect 
any running copies of SunDraw. You must quit SunDraw and start it again. 

If your system administrator installed the STAGE products in /usr / sundesk , the default file can be found in 
/usr/sundesk/sundraw/dot.sundraw. 


## SunDraw environment variables 

## 


# This file is read by SunDraw at program startup. 

# It contains user defaults to SunDraw parameters. 

# 

# The keyword can be either in upper case or lower 

# case characters. 

# 

# The general format for setting a SunDraw variable 

# is... 

# 

# RASTER_TYPE 2 

# 

# where RASTER_TYPE is the keyword, and 

# 2 is its value. 

# 

# Comment lines contain a '#' character in the first 

# position on that line and is ignored by SunDraw. 

# 

# DO NOT use tabs in this file. 

# 

#Key Word Arguments Default Description 

# (if any) value 


#FONTS 

string 

FONTS controls the absolute path to 

# 


the directory where SunDraw fonts are 

# 


installed. 

# 


The default value is attached by the 

# 


SunDraw Install Process. 
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^ # 



N 

#SIMPLE_ 

CUT none 

SIMPLE_CUT controls the type of files 


# 


that are created when performing 


# 


cut/paste operations in SunDraw. 


# 


When SIMPLE__CUT is disabled the 


# 


Encapsulated Postscript file and the 


# 


vector (.vec) files are created. 


# 


If the user anticipates a lot of clip- 


# 


board activity between SunDraw and 


# 


SunWrite/SunPaint, then SIMPLE CUT 


# 


must be disabled. On the other hand. 


# 


enabling SIMPLE_CUT will speed up the 


# 


clipboard operations in SunDraw, but 


# 


the user cannot cut and paste between 


# 

41 . 


SunDraw and SunWrite/SunPaint. 


#CLIPBOARD string 

”/tmp/sun desk clipboard" 


# 


CLIPBOARD controls the filename which 


# 


is used for all edit operations in 


# 


SunDraw. The filename should be the 


# 


same as GRAPHICSCLIPFILE in the 


# 


.sunwrite file and CLIPBOARD in 


# 


the .sunpaint file if the user 


# 


anticipates clipboard operations 


# 

# 


across these applications. 


# 

There will be two (2) files created. One with an extension 


# 

.vec and the other with no extension. To cut and paste from 


# 

SunDraw into SunWrite or SunPaint, both the files are needed. 


# 

If you do not intend to cut and paste between applications,- 


# 

then enable the 

variable SIMPLE_COT at the end of this file. 


# 

Enabling SIMPLE 

_CUT will result in files only with the .vec 


# 

# 

extension. (By default SIMPLE_CUT is disabled) 


# 

♦MARKERS 

none 

MARKERS enables a visual guide (+) at 


# 


the origin of an object when drawing. 


#UNIT_TYPE [0-4] 

2 UNIT__TYPE controls the default display 


# 


unit for rulers andgrids in SunDraw. 


# 


Valid values are: 


# 


0 - MILLIMETERS 


# 


1 - CENTIMETERS 


# 


2 - INCHES 


# 


3 - POINTS 


# 

4 


4 - PICAS 


#PAGE_SIZE w, h 

8.0, 10.75 PAGE_SIZE controls the dimensions of a 


# 


default SunDraw page, w is the width 


# 


and h is the height of the page, in 


# 


UNIT_TYPE. To avoid "posterization", 


# 


X should be less than or equal to 8.0 


# 

.. . 


inches (203.2 mm) and y should be less 
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r 

# 


than or equal to 10.75 inches (273 mm). 

# 


"Posterization" is when the printer 

# 


spreads a large picture out over 

# 


several pages. 

# 



#RASTER_TYPE 

[0-2] 2 

RASTER__TYPE controls the type of 

# 


raster that is rendered in SunDraw. 

# 


Valid values are: 

# 


0 - RT_0LD 

# 


1 - RT_STANDARD 

# 


2 - RT_BYTE__ENCODED 

# 



# 



## Current Values 


## 



# 



CLIPBOARD 

" /tmp/sundesk_clipboard’' 


RASTER_TYPE 

2 


UNIT_TYPE 

2 


PAGE_SIZE 

8.00, 10.75 


MARKERS 

V_ 
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SunWrite Printer Script 

Sun Write Printer Script. 



















































c 


c 



SunWrite Printer Script 


sunwrite. print is the Shell script which SunWrite uses to direct output to 
the printing device. 

The script is set up assuming that /usr/ucb/lpr is the print spooler in use. 


You can change the script to suit your local installation as long as you adhere to 
the calling convention stated in the script. 






















E 


SunDraw Printer Script 


sundraw, print is the Shell script which SunDraw uses to direct output to the 
printing device. 

The script is set up assuming that /usr/ucb/Ipr is the print spooler in use. 

You can change the script to suit your local installation as long as you adhere to 
the calling convention stated in the script. 

Note that when SunDraw is generating raster output, it uses the pssun utility 
which is part of the TranScript software package from Adobe Systems Incor¬ 
porated. If you have a raster to PostScript conversion utility other than ps sun, 
you will need to ensure that the parameter conventions of ps sun are adhered to 
by your utility. 
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shift 2 ;; ' 

-r) 

rotate=”-r” 
shift ;; 

- 2 ) 

double=”-2” 
shift ;; 

-S) 

scale=”-S $2” 
shift 2 ;; 

-s) 

scale=="-s $2 $3” 
shift 3 ;; 

- 1 ) 

position=”~l $2 $3” 
shift 3 ;; 

-P) 

printer=$2 
shift 2 ;; 

*) 

filename=$l 
break ;; 
esac 

done 

#printing to a file as raster means we turn off the filter so as to 
#save data in raster form 

if test $print_to_file -eq 1 -a -n ”$filter" ; then 
filter= 
fi 

if test $print_to__file -eq 1 ; then 

if test ”$file_type” = "postscript” ; then 

cp ”$filename” ”$printfile” 

else 

cat > $printfile 
fi 

else 

if test ~n ”$filter” ; then 

$filter $rotate $double $scale $position < $filename | $printcommand -r -P$printer 
else 

$printcommand ^r --P$printer $filename 
fi 
fi 

V_____/ 
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SunPaint Printer Script 


sunpaint .print is the Shell script which SunPaint uses to direct output to 
the printing device. 

The script is set up assuming that /usr/ucb/lpr is the print spooler in use. 

You can change the script to suit your local installation as long as you adhere to 
the calling convention stated in the script. 

Note that SunPaint uses the ps sun utility which is part of the TranScript 
software package from Adobe Systems Incoiporated. If you have a raster to 
PostScript conversion utility other than ps sun, you will need to ensure that the 
parameter conventions of pssun are adhered to by your utility. 


#!/bin/sh 


filter=pssun 

printfile= 

rotate= 

double= 

scale= 

position= 

printer=lw 

print_to_file=0 

printcommand=/usr/ucb/lpr 

for i in $* 
do case $1 in 
-f) 

printfile=$2 
print_to_file=l 
shift 2 ;; 

-r) 

rotate=”“r” 
shift ;; 

- 2 ) 

double-”“2” 
shift ;; 

-S) 

scale=”“S $2” 
shift 2 ;; 

-s) 


6 ' 






SunWrite-SunPaint-SunI>raw Installation Guide 



scale=”“-s $2 $3” 
shift 3 ;; 

-I) 

position=”“l $2 $3” 
shift ^ ;; 

-P) 

printer=$2 
shift 2 ;; 

*) 

filename=$l 
break ;; 


if test $print_to_file -eq 0 

then $filter $rotate $d.ouble $scale $position < $filename | $printcommand -r “P$printe] 
else $filter $rotate $double $scale $position < $filename >$printfile 
fi 
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